##############################################################################
###+---------+################################################################
#+-| RIGHT() |----------------------------------------------+#################
#| +---------+ Returns number characters from source_string |#################
#+----------------------------------------------------------+#################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |-----------------------------------------------------+##########
#|     FUNCTION CHAR right PROTOTYPE                               |##########
#|      PARAMETERS CONST CHAR source_string, VALUE UINT number     |##########
#+-----------------------------------------------------------------+##########
##############################################################################
##############################################################################
###########+---| Description |-----------------------------------+############
###########| The right() function returns number characters from |############
###########| source_string, starting at the far right character. |############
###########+-----------------------------------------------------+############
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? right("FORCE compiler      ", 10)                      |#########
#########| *---- prints: "FORCE comp"                               |#########
#########|                                                          |#########
#########| ? len( right( zstring, 1 ))  && prints 1                 |#########
#########| ? len( right( "this", 0))    && prints 0                 |#########
#########| ? right( "A string",255 )    && prints "A string"        |#########
#########+----------------------------------------------------------+#########
##############################################################################